home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / flomsg15.arc / FLO2MSG.DOC < prev    next >
Text File  |  1991-05-25  |  13KB  |  324 lines
  1.  
  2.  
  3.                           FLO2MSG Documentation
  4.                                   v1.50
  5.               Copyright (C) 1990, 1991 by Blue Wave Software
  6.                            All Rights Reserved.
  7.  
  8.  
  9.  
  10.   WHAT IS IT?
  11.   ~~~~~~~~~~~
  12.   To be completely honest, FLO2MSG was never meant to be anything but a
  13.   program for us and a few friends to use.  Basically, the fastest
  14.   echomail .MSG tosser/scanner/packer available was incompatible in it's
  15.   file attach types with FrontDoor, the mailer which we wanted to run.
  16.  
  17.   So, basically, we wrote a program that read all of the possible .?LO
  18.   combinations (.CLO, .DLO, .FLO, .HLO), and wrote them into a format that
  19.   FrontDoor recognized [.MSG files].
  20.  
  21.   There is nothing magic about FLO2MSG;  it won't wash your windows, or
  22.   make your coffee in the morning.  However, it is quite a handy little
  23.   program, not only to convert file attach types, but also to do a quick
  24.   POLL, or a quick FILE ATTACH.  It comes in handy in maintenance batch
  25.   files to generate polls, or regularly attach files to mail feeds such
  26.   as the weekly NODEDIFF and FIDONEWS.  You can even make a FILE ATTACH
  27.   message contain a form-letter text file, if you like.
  28.  
  29.   You can even make FILE REQUESTS with FLO2MSG.  I use it regularly in
  30.   my batch file to file request the latest NODEDIFF from our Region
  31.   Coordinator.
  32.  
  33.   You can send "BOMBS", making it easy to send 1 file to more than 1 node
  34.   at a time.  I BOMB my nodes the NODEDIFF every week.
  35.  
  36.   There is no registration fee required to use FLO2MSG; you may use it
  37.   forever and it will not blow up or leave nasty notes scattered on your
  38.   hard drive.  However, a small donation (even $2) would be greatly
  39.   appreciated, and will encourage us to maintain and update the program
  40.   with user requests.  If you aren't the type to send cash, how about a
  41.   postcard or a letter [or a six pack (Bud Light, please)]?  You can send
  42.   your overwhelming thoughtfulness to:
  43.  
  44.   Blue Wave Software
  45.   PO Box 1057
  46.   Flint, MI  48503
  47.  
  48.   You can address questions and comments via FidoNet netmail, if you like,
  49.   to the following nodes:
  50.  
  51.   1:2240/107   Fred Rappuhn
  52.   1:2240/176   George Hatchew
  53.  
  54.   All questions and comments will be replied to and placed on hold within
  55.   24 hours.  They will be kept up to 7 days.  If you are one who has shown
  56.   your gratitude, we will, of course, send your Netmail reply on our dime.
  57.   It's just that we would go broke, otherwise.
  58.  
  59.  
  60.  
  61.  
  62.   HOW TO USE FLO2MSG
  63.   ~~~~~~~~~~~~~~~~~~
  64.   Before we forget, you can get all of the following information, in
  65.   condensed form, by typing:
  66.  
  67.   FLO2MSG ?
  68.  
  69.   at the DOS prompt.
  70.  
  71.   In order to know important things about your system, it is necessary for
  72.   FLO2MSG to read some type of configuration file.  FLO2MSG searches for 2
  73.   CFG_FILE_NAMEs by default;  FLO2MSG.CFG, and QM.CFG.
  74.  
  75.   If the CFG_FILE_NAME lies somewhere on the DOS path, FLO2MSG will find
  76.   it.  No need to execute it from the directory that FLO2MSG takes up
  77.   space in.
  78.  
  79.   Here is the order that FLO2MSG searches for a CFG_FILE, if none is
  80.   specified on the command line:
  81.  
  82.   FLO2MSG.CFG on the current drive/path.
  83.   FLO2MSG.CFG on the DOS PATH.
  84.   QM.CFG on the current drive/path.
  85.   QM.CFG on the DOS PATH.
  86.  
  87.   If you specify a CFG_FILE_NAME on the command line, FLO2MSG looks
  88.   exactly where you tell it to look, then in the DOS PATH.
  89.  
  90.   The CFG_FILE should contain the following lines:
  91.  
  92.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  93.   Primary_Zone 1                <== Your primary Zone Number.
  94.   Address      2240/176         <== Your address in the form NET/NODE
  95.   NetMail      d:\fd\mail       <== Your mailer's NetMail Directory
  96.   OutBound     d:\fd\out        <== The place where the .?LO files are.
  97.   SysOp        Your Name        <== If this line is found, FLO2MSG places
  98.                                     Your Name in a SEND, rather than from
  99.                                     "Sysop".  Completely OPTIONAL!
  100.   DBridge      d:\db            <== If this line is found, then FLO2MSG
  101.                                     will create DBRIDGE.RSN in your
  102.                                     D'Bridge directory causing D'Bridge
  103.                                     to rescan for outgoing mail.
  104.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  105.  
  106.   A sample file, called FLO2MSG.CFG, should have been included in your
  107.   archive.
  108.  
  109.  
  110.   A.  File attach conversions:
  111.       ~~~~~~~~~~~~~~~~~~~~~~~~
  112.       To convert .?LO files into *.MSG type file attaches is really quite
  113.       simple.  After your normal mail processor has scanned and mashed
  114.       your outgoing mail, and has built the .?LO files, simply run the
  115.       command line:
  116.  
  117.       FLO2MSG <CFG_FILE_NAME>
  118.  
  119.       If *NO* CFG_FILE_NAME is specified, FLO2MSG will look for QM.CFG.
  120.       The .?LO files in the OutBound directory will be erased, and a
  121.       NetMail Message will be created, with the FILE ATTACH flag set, in
  122.       your NetMail directory.
  123.  
  124.       If the file attach is marked as TRUNCATE SENT or DELETE SENT by your
  125.       mail processor, FLO2MSG will use the same status when creating the
  126.       .MSG file with the ^AFLAGS directive used by D'Bridge and FrontDoor.
  127.  
  128.       Rest easy...  If the file has already has a corresponding FILE
  129.       ATTACH message, a new one will *not* be created.
  130.  
  131.       FLO2MSG will also respect the CRASH, DIRECT, NORMAL, and HOLD status
  132.       on the .?LO files, so if you like, you can do your routing with your
  133.       mail processor, rather than FD or D'Bridge.
  134.  
  135.       !!!WARNING!!!
  136.       ~~~~~~~~~~~~~
  137.       We have no idea how Other<tm> mail processors operate, but we had to
  138.       LIE to QMail about where our NetMail directory was.  When QMail does
  139.       a PACK of the outgoing mail, it wanted to convert all of the *.MSG
  140.       file attach messages BACK into *.?LO files.  Can you say vicious
  141.       circle?  We thought you could :-).
  142.  
  143.       The fix?  For QMail, tell it your correct NetMail directory in QM.CFG.
  144.       However, in QM_ROUTE.CFG, under *each* schedule you may have defined,
  145.       insert a line called:
  146.  
  147.       NETMAIL_SCAN drive:\somewhere\there\are\NO\*.MSG files
  148.  
  149.       This will prevent QMail from packing your netmail area for you.
  150.       We suggest a directory that contains absolutely NO *.MSG files, as it
  151.       will speed up QMail's scan of the "netmail" area.
  152.  
  153.   B.  Generating POLLS
  154.       ~~~~~~~~~~~~~~~~
  155.       You can generate a poll to a system, either from a batch file or
  156.       from the command line by simply entering:
  157.  
  158.       FLO2MSG <CFG_FILE_NAME> POLL NET/NODE
  159.  
  160.       If you needed to generate a poll to 2240/107, you would simply use
  161.       the command line:
  162.  
  163.       FLO2MSG FLO2MSG.CFG POLL 2240/107
  164.  
  165.       Pretty simple, eh?
  166.  
  167.   C.  Generating FILE ATTACH MESSAGES
  168.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  169.       You can generate a file attach message to a system by using the
  170.       command line:
  171.  
  172.       FLO2MSG <CFG_FILE_NAME> SEND NET/NODE DRIVE:\PATH\FILENAME.EXT
  173.  
  174.       If you needed to send a file to 2240/176, you would simply use the
  175.       command line:
  176.  
  177.       FLO2MSG FLO2MSG.CFG SEND 2240/176 C:\BREWERY\BUD.LIT
  178.  
  179.  
  180.       Do you regularly send the same files to the same people, and use
  181.       some cheesy form letter in the message text of your attach message?
  182.       If so, let FLO2MSG insert your cheesy form letter into the message
  183.       it is about to create for your file attach.  The command line is
  184.       simple:
  185.  
  186.       FLO2MSG <cfg_file_name> SEND NET/NODE FILENAME.EXT with MSG.TXT
  187.  
  188.       To send the node 2240/176 a file called c:\brewery\bud.lit and include
  189.       the cheesy message text contained within BEER.TXT, you would use:
  190.  
  191.       FLO2MSG flo2msg.cfg SEND 2240/176 c:\brewery\bud.lit with beer.txt
  192.  
  193.       By the way, full drive and path names are supported in both the WITH
  194.       parameter, and the SENDfile parameter.
  195.  
  196.  
  197.       Say you want to send a file to someone with a quick message, but you
  198.       don't feel like creating a file to attach with FLO2MSG nor do you feel
  199.       like booting up your favorite NetMail program to enter the message.
  200.  
  201.       Why not try this neat little trick!!!
  202.  
  203.       FLO2MSG <cfg_file_name> SEND 2240/107 <filename.ext> WITH CON
  204.  
  205.       The CON for the text file name at the end tells FLO2MSG that you want
  206.       to enter a message on the fly.  All you have to do is type your message
  207.       making sure you hit a return at the end of every line and then when you
  208.       are all done, hit CTRL-Z on a line by itself followed by a <ENTER>.
  209.       Remember that you are not in a text editor, meaning you will not be able
  210.       to edit a line once you hit <ENTER>.
  211.  
  212.   D.  Sending BOMBS
  213.       ~~~~~~~~~~~~~
  214.       FLO2MSG makes it simple to do routine sending of files to a
  215.       list of nodes.  When issued the command:
  216.  
  217.       FLO2MSG <CFG_FILE_NAME> BOMB MYNET C:\INBOUND\NODEDIFF.* {with MSG}
  218.  
  219.       FLO2MSG will look for a file called BOMB.LST;  first in the current
  220.       directory, and then in the DOS PATH.  The format of BOMB.LST is:
  221.  
  222.       ------------------------------------------
  223.       BOMB_TAG MyNet
  224.  
  225.          Net/Node     Sysop Name     Priority
  226.          Net/Node     Sysop Name     Priority
  227.  
  228.       BOMB_TAG OtherNet
  229.  
  230.          Net/Node     Sysop Name     Priority
  231.          Net/Node     Sysop Name     Priority
  232.       ------------------------------------------
  233.  
  234.       You may have as many BOMB_TAGs as you please in BOMB.LST.  You may
  235.       also list as many net/nodes WITHIN the BOMB_TAG as you please.
  236.  
  237.       Net/Node is, of course, the standard Fido-Style Net/Node address of
  238.       the person you are sending the file to; such as 2240/107.
  239.  
  240.       Sysop Name is the name of the Sysop who runs that particular node.
  241.  
  242.       Priority may be one of 4 keywords:
  243.  
  244.       IMMEDIATE    <- As supported by FD and D'Bridge with ^AFLAGS kludge.
  245.       CRASH
  246.       NORMAL
  247.       HOLD
  248.  
  249.       There should have been a sample BOMB.LST file in your FLO2MSG
  250.       archive.  You may also send BOMBS with text contained in the
  251.       message, as outlined above under "C.  Generating FILE ATTACH MSGS".
  252.  
  253.  
  254.   E.  Generating FILE REQUEST MESSAGES
  255.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  256.       Is your NC or RC one who doesn't file attach and send you the latest
  257.       NODEDIFF every week?  Do you always sit down and manually request
  258.       NODEDIFF in a weekly ritual?  Why not automate it, and do it from a
  259.       scheduled event, and let your batch files and FLO2MSG take care of
  260.       it?
  261.  
  262.       You can generate a FILE REQUEST message to a system by using the
  263.       command line:
  264.  
  265.       FLO2MSG <CFG_FILE_NAME> GET NET/NODE FILENAME.EXT
  266.  
  267.       If you needed to file request NODEDIFF every week from 2240/107, you
  268.       would simply use the command line:
  269.  
  270.       FLO2MSG FLO2MSG.CFG GET 2240/107 Nodediff
  271.  
  272.       If you like, you can include some TEXT in the file request message
  273.       by using the "WITH" command, as described in (C) above [sending
  274.       files with messages].
  275.  
  276.   F.  CLEANING THE OUTBOUND AREA
  277.       ~~~~~~~~~~~~~~~~~~~~~~~~~~
  278.       Is your mailer/BBS one who doesn't truncate or delete it's own
  279.       EchoMail bundles, but rather relies on the mail processor to
  280.       truncate them?
  281.  
  282.       You can perform a sweep-up of your outbound area by issuing the
  283.       command:
  284.  
  285.       FLO2MSG <CFG_FILE_NAME> CLEANUP
  286.  
  287.       FLO2MSG will scan the outbound area for any ARCmail bundles lying
  288.       around, and compare what it finds with the Netmail directory and
  289.       it's *.MSG files.  If the ARCmail bundle has *NO* corresponding
  290.       *.MSG file attach message, *or* if there is a message sitting there,
  291.       but it has been marked as SENT, the ARCmail bundle will be truncated
  292.       to 0 bytes.
  293.  
  294.       Use this command with caution;  we will not be responsible for an
  295.       entire NET loosing their echomail bundle because of a goof-up!  When
  296.       used properly, the command works fine.  If you accidentally delete
  297.       the file attach message before the file is sent, and run a CLEANUP,
  298.       the bundle is gone.  For good.  But, as you probably know if you
  299.       need this command, it's the exact same thing mail processors such as
  300.       CONFMAIL would do in this situation.
  301.  
  302.  
  303.   THE STANDARD, BORING STUFF
  304.   ~~~~~~~~~~~~~~~~~~~~~~~~~~
  305.   FLO2MSG has been run for several months on our systems, and a few of our
  306.   friends without trouble.  However, this does not mean that it will be
  307.   compatible with your mail processor.  If you have a special need that
  308.   you would like added in a future version, just let us know.  We'll try
  309.   to incorporate it if we get a good enough response.
  310.  
  311.  
  312.  
  313.   CREDIT, WHERE CREDIT IS DUE
  314.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  315.   Bruce Wilson, for spreading the word to SpitFire SysOps World-wide.
  316.   Tim Pickett, for spreading the word to PCBoard SysOps World-wide.
  317.   Dan Butterfield, for finding bug number one.
  318.   Qmail is a copyrighted work of Greg Dawson.
  319.   FrontDoor is a copyrighted work of Joaquim Homrighausen.
  320.   D'Bridge is a copyrighted work of Chris Irwin.
  321.   FLO2MSG is a copyrighted work of Blue Wave Software.
  322.   Everything is a copyrighted work of Someone <does that cover everything?>
  323.  
  324.